<!DOCTYPE html>
<html lang="en">

<head>
    <meta charset="UTF-8">
    <title>[3.1]-扩展类库：微信开发 | PhalApi(π框架) - PHP轻量级开源接口框架 - 助你创造价值！</title>
    <meta name="viewport" content="width=device-width,initial-scale=1,minimum-scale=1,maximum-scale=1,user-scalable=no" />
    <meta content="yes" name="apple-mobile-web-app-capable">
    <meta content="black" name="apple-mobile-web-app-status-bar-style">
    <meta content="telephone=no" name="format-detection">
    <meta content="email=no" name="format-detection">
    <meta name="Author" content="PhalApi,ecitlm,dogstar">
    <meta name="description" content="[3.1]-扩展类库：微信开发，PhalApi是一个PHP轻量级开源接口框架，致力于快速开发接口服务。支持HTTP/SOAP/RPC等协议，可用于搭建接口/微服务/RESTful接口/Web Services。我们不断更新，保持生气；为接口负责，为开源负责！并承诺永久免费！">
    <meta name="keywords" content="PhalApi,phalapi,phalapi接口开发,后台接口开发,后台接口开发框架,接口开发,接口框架,开源接口框架,PHP后台接口开发,PHP接口开发,PHP接口框架,PHP后台接口框架,phalapi官网,PHP接口框架,php接口开发框架,php接口开发,php web框架,π框架,π开发框架,π接口框架,π接口开发框架,api接口,php接口,,PHP接口框架,phalapi文档,phalapi wiki,PhalApi文档,phalapi在线文档,phalapi官方文档">

    <link rel="stylesheet" type="text/css" href="https://cdn.bootcss.com/bootstrap/3.3.7/css/bootstrap.min.css" media="screen">
    <link rel="stylesheet" type="text/css" href="https://cdn.bootcss.com/font-awesome/4.7.0/css/font-awesome.css" media="screen">
    <link rel="stylesheet" href="../css/main.css" />
    <link rel="stylesheet" href="../css/loading_bar.css" />
    <link rel="icon" href="http://webtools.qiniudn.com/dog_catch.png" type="image/x-icon" />
    <script src="../js/pace.min.js"></script>
	
	<!-- 代码高亮 -->
	<link rel="stylesheet" href="../css/highlight.min.css">
	<script src="../js/highlight.min.js"></script>
	<script>hljs.initHighlightingOnLoad();</script>
    
</head>

<body>
    <!-- navbar start -->
    <div class="navbar navbar-default navbar-fixed-top" id="mainnav" role="navigation">
        <div class="container">
            <div class="navbar-header">
                <button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target=".navbar-collapse">
                    <span class="sr-only">Toggle navigation</span>
                    <span class="icon-bar"></span>
                    <span class="icon-bar"></span>
                    <span class="icon-bar"></span>
                </button>
                <a class="navbar-brand website_name" href="/"><!-- <span>PhalApi</span> --><strong>PhalApi</strong></a>
            </div>
            <div class="navbar-collapse collapse" aria-expanded="false" style="height: 1px;">
                <ul class="nav navbar-nav navbar-right" id="nav_bar">
                    <li><a href="/"><span class="glyphicon glyphicon-home"></span></a></li>
                    <li><a href="http://qa.phalapi.net/">社区</a></li>
                    <li><a href="/download.html">下载</a></li>
                    <li class="active"><a href="/wikis/">文档</a></li>
                    <li><a href="http://www.ituring.com.cn/book/2405">书籍</a></li>
                    <li><a href="http://demo.phalapi.net/">体验</a></li>
                    <li><a href="/about.html">关于</a></li>
                    <li><a href="/donate.html">贡献</a></li>
                    <li><a href="/wikis/en/">English</a></li>
                </ul>
            </div>
            <!--/.nav-collapse -->
        </div>
    </div>
    <!-- navbar end -->


    <div id="content">
        <div class="container">
            <div class="row row-md-flex row-md-flex-wrap">
                <h4><a href="/wikis/%5B2.22%5D-%E6%9B%B4%E5%A4%9A%E5%B7%A5%E5%85%B7%EF%BC%9A%E7%B2%BE%E7%9B%8A%E9%A1%B9%E7%9B%AE%E5%92%8C%E5%9B%A2%E9%98%9F%E5%BB%BA%E8%AE%BE.html">上一章</a>   <a href="/wikis/">文档首页</a>   <a href="/wikis/%5B3.2%5D-%E6%89%A9%E5%B1%95%E7%B1%BB%E5%BA%93%EF%BC%9A%E4%BB%A3%E7%90%86%E6%A8%A1%E5%BC%8F%E4%B8%8Bphprpc%E5%8D%8F%E8%AE%AE%E7%9A%84%E8%BD%BB%E6%9D%BE%E6%94%AF%E6%8C%81.html">下一章</a></h4>
<hr />
<h2>3.1.1 扩展类库：微信开发</h2>
<p>此扩展可用于微信的服务号、订阅号、企业号等功能开发，在PhalApi框架下简单配置即可开发使用。  </p>
<p>更多请参考<a href="http://git.oschina.net/dogstar/WechatRobot">WechatRobot - PHP微信机器人开发包</a>。</p>
<h2>3.1.2 安装和配置</h2>
<h3>(1)扩展包下载</h3>
<p>从  <a href="http://git.oschina.net/dogstar/PhalApi-Library">PhalApi-Library</a>  扩展库中下载获取 <strong>Wechat</strong> 微信包，如使用：</p>
<pre><code class="language-bash">$ git clone https://git.oschina.net/dogstar/PhalApi-Library.git</code></pre>
<p>然后把 <strong>Wechat</strong> 目录复制到 <strong>./PhalApi/Library/</strong> 下，即：</p>
<pre><code class="language-bash">$ cp ./PhalApi-Library/Wechat/ ./PhalApi/Library/ -R</code></pre>
<p>到此安装完毕！接下是插件的配置。</p>
<h3>(2)扩展包配置</h3>
<p>为了让微信扩展包能接收来自微信服务器的信息以及返回信息给用户，我们需要在 <strong>./Config/app.php</strong> 配置文件中追加以下配置：</p>
<pre><code class="language-php">
    /**
     * 插件注册 - 项目级重用
     */
  'Wechat' =&gt; array(
    'plugins' =&gt; array(
        Wechat_InMessage::MSG_TYPE_TEXT =&gt; array('Plugin_Menu',),
        Wechat_InMessage::MSG_TYPE_IMAGE =&gt; array(),
        Wechat_InMessage::MSG_TYPE_VOICE =&gt; array(),
        Wechat_InMessage::MSG_TYPE_VIDEO =&gt; array(),
        Wechat_InMessage::MSG_TYPE_LOCATION =&gt; array(),
        Wechat_InMessage::MSG_TYPE_LINK =&gt; array(),
        Wechat_InMessage::MSG_TYPE_EVENT =&gt; array(),
        Wechat_InMessage::MSG_TYPE_DEVICE_EVENT =&gt; array(),
        Wechat_InMessage::MSG_TYPE_DEVICE_TEXT =&gt; array(),
    ),
  )
</code></pre>
<p>简单说明一下上面配置的作用，很明显，Key为对应的消息类型，如：文本、位置、语音、图片等；然后是各种消息类型对应的处理的类名，可以有多个，从上到下依次处理。<br />
如果觉得配置很多，可以只配置需要用到的消息类型。另外，如果你的配置是其他途径存放的，也亦然。  </p>
<h2>3.1.3 入门使用</h2>
<h3>(1)微信入口文件</h3>
<p>可以按将下面的入口代码得到你的项目下：</p>
<pre><code class="language-php">//$ vim ./Public/weixin/index.php 

&lt;?php

// echo $_GET['echostr'];
// die();

if (!isset($GLOBALS['HTTP_RAW_POST_DATA'])) {
    die('Access denied!');
}

require_once dirname(__FILE__) . '/../init.php';

//装载项目代码和扩展类库
DI()-&gt;loader-&gt;addDirs(array('Demo', 'Library'));

/** ---------------- 微信轻聊版 ---------------- **/

$robot = new Wechat_Lite('YourTokenHere...', true);
$rs = $robot-&gt;response();
$rs-&gt;output();</code></pre>
<p><strong>特别地</strong> ，当首次接入微信时，需要将开头的两句注释去掉，以便通过微信的验证，即：</p>
<pre><code class="language-php">// echo $_GET['echostr'];
// die();</code></pre>
<h2>3.1.4 示例：让红包飞</h2>
<h3>(1)业务场景</h3>
<p>现在，快要过年了，各大企业都在派红包，这里，我们也模拟一下微信服务号上红包的派发。   </p>
<p>通常地，当我们需要添加一个新的微信服务号的功能时，可以两步走： <strong>先开发插件，再注册插件</strong> 。</p>
<h3>(2)开发插件</h3>
<p>很简单地：</p>
<pre><code class="language-php">// $vim ./Demo/Plugin/Money.php 

&lt;?php

class Plugin_Money implements Wechat_Plugin_Text {

    public function handleText($inMessage, &amp;$outMessage) {
        $outMessage = new Wechat_OutMessage_News();

        $item = new Wechat_OutMessage_News_Item();
        $item-&gt;setTitle('让红包飞~')
            -&gt;setDescription(sprintf('您已领取到一个%d元红包~', rand(1, 100)))
            -&gt;setPicUrl('http://webtools.qiniudn.com/172906_61c8663a_121026.jpeg')
            -&gt;setUrl('http://git.oschina.net/dogstar/PhalApi-Library');

        $outMessage-&gt;addItem($item);
    }
}</code></pre>
<h3>(3)注册插件</h3>
<p>开发好插件后，需要在配置添加对哪种消息开启使用该新的插件。在 <strong>./Config/app.php</strong> 配置文件中追加以下配置：</p>
<pre><code class="language-php">        // 前面配置略 ...

        // 在前面追加红包插件，处理顺序由左到右
        Wechat_InMessage::MSG_TYPE_TEXT =&gt; array('Plugin_Money', 'Plugin_Menu', ), 
</code></pre>
<h3>(4)运行效果</h3>
<p><img src="http://webtools.qiniudn.com/20150411005257_976929b37873ae51ca54d5cb24a61ff0" alt="webwxgetmsgimg" />  </p>
<h2>3.1.5 微信开发调试</h2>
<p>为了便于进行微信开发的调试，我们专门提供了一个快速模拟微信请求的脚本。以下是对上面发红包的模拟请求：</p>
<pre><code class="language-bash">$php ./Library/Wechat/Tests/send_wechat_text.php http://dev.wechat.com/weixin/ demo

&lt;xml&gt;
&lt;ToUserName&gt;&lt;![CDATA[oWNXvjipYqRViMpO8GZwXxE43pUY]]&gt;&lt;/ToUserName&gt;
&lt;FromUserName&gt;&lt;![CDATA[gh_43235ff1360f]]&gt;&lt;/FromUserName&gt;
&lt;CreateTime&gt;1423821388&lt;/CreateTime&gt;
&lt;MsgType&gt;&lt;![CDATA[news]]&gt;&lt;/MsgType&gt;
&lt;ArticleCount&gt;1&lt;/ArticleCount&gt;
&lt;Articles&gt;
&lt;item&gt;
&lt;Title&gt;&lt;![CDATA[让红包飞~]]&gt;&lt;/Title&gt;
&lt;Description&gt;&lt;![CDATA[您已领取到一个85元红包~]]&gt;&lt;/Description&gt;
&lt;PicUrl&gt;&lt;![CDATA[http://webtools.qiniudn.com/172906_61c8663a_121026.jpeg]]&gt;&lt;/PicUrl&gt;
&lt;Url&gt;&lt;![CDATA[http://git.oschina.net/dogstar/PhalApi-Library]]&gt;&lt;/Url&gt;
&lt;/item&gt;
&lt;/Articles&gt;
&lt;FuncFlag&gt;0&lt;/FuncFlag&gt;
&lt;/xml&gt;</code></pre>
<hr />
<h4><a href="/wikis/%5B2.22%5D-%E6%9B%B4%E5%A4%9A%E5%B7%A5%E5%85%B7%EF%BC%9A%E7%B2%BE%E7%9B%8A%E9%A1%B9%E7%9B%AE%E5%92%8C%E5%9B%A2%E9%98%9F%E5%BB%BA%E8%AE%BE.html">上一章</a>   <a href="/wikis/">文档首页</a>   <a href="/wikis/%5B3.2%5D-%E6%89%A9%E5%B1%95%E7%B1%BB%E5%BA%93%EF%BC%9A%E4%BB%A3%E7%90%86%E6%A8%A1%E5%BC%8F%E4%B8%8Bphprpc%E5%8D%8F%E8%AE%AE%E7%9A%84%E8%BD%BB%E6%9D%BE%E6%94%AF%E6%8C%81.html">下一章</a></h4><div style="float: left">
<h4>
<a href="http://qa.phalapi.net/">还有疑问？欢迎到社区提问！</a>
</h4>
</div>
            </div>
        </div>
    </div>

 <!-- 广告位 -->
<div class="grid-wrapper desktop-only">
	<p align="center">
		<a href="http://7xiz2f.com1.z0.glb.clouddn.com/%E6%88%91%E7%9A%84%E5%90%8D%E5%AD%97%E5%8F%AB%EF%BC%9A%CF%80%E6%A1%86%E6%9E%B6%20-%20PhalApi%202016%E5%B9%B4%E5%BA%A6%E5%BC%80%E6%BA%90%E6%80%BB%E7%BB%93%20-%20%E5%AE%98%E6%96%B9%E5%87%BA%E5%93%81.pdf" target="blank"><img width="950" height="100" src="http://7xiz2f.com1.z0.glb.clouddn.com/ad_20170104.png"></a>
		<a href="http://www.itran.cc/" target="blank"><img width="950" height="100" src="http://7xslqv.com1.z0.glb.clouddn.com/images/9/69/b88bc92455dc1239f9a5bf8d72929.png"></a>
		<a href="http://web-tools.phalapi.net/" target="blank"><img width="950" height="100" src="http://7xslqv.com1.z0.glb.clouddn.com/images/7/d0/88f523566c482296aecc43d185ca2.png"></a>
	</p>
</div>

        <!-- footer -->
        <div class="footer">
            <div class="link container ">
                <div class=" col-xs-7 col-sm-7 col-md-7 col-lg-7 ">
                    <h3>PhalApi (π框架)</h3>
                    <p>一个轻量级PHP开源接口框架，专注于接口服务开发，支持HTTP/SOAP/RPC协议，拥有自动生成的在线文档、多种开发语言的客户端SDK包以及可重用的扩展类库，可用于快速搭建微服务、RESTful接口或Web
                        Services。</p>
                    <!-- <p>:</p> -->
                    <span>友情链接:</span>
                    <a href="https://www.phalapi.net/" target="_blank"> PhalApi </a>
                    <a href="http://www.oschina.net/" target="_blank"> 开源中国 </a>
                    <a href="https://www.itran.cc/" target="_blank">艾翻译</a>
                    <a href="http://www.phalconphp.com/en/" target="_blank">Phalcon</a>
                    <a href="https://phpunit.de/manual/3.7/zh_cn/automating-tests.html" target="_blank">PHPUnit</a>
                    <a href="http://www.thoughtworks.com/cn/" target="_blank">ThoughtWorks</a>
                    <a href="mailto:chanzonghuang@gmail.com">友链交换</a>

                </div>
                <div class=" col-xs-5 col-sm-5 col-md-5 col-lg-5 contact_us ">
                    <h3>联系我们</h3>
                    <a href="https://github.com/phalapi/phalapi"><img src="../images/github.png" alt="github" /></a>
                    <a href="http://weibo.com/p/100808d236e99beb645bfb56ed1c37dde9b8bd?k=phalapi%E5%BC%80%E6%BA%90%E6%A1%86%E6%9E%B6&from=501&_from_=huati_topic"><img src="../images/weibo.png"  alt="weibo" /></a>
                    <a href="http://7xslqv.com1.z0.glb.clouddn.com/images/1/b0/894fde762850cb11250253f7d5ede.png"><img src="../images/zfb.png"  alt="zfb" /></a>
                    <a href="https://jq.qq.com/?_wv=1027&k=4A6reum"><img src="../images/qq.png"  alt="qq" /></a>
					<a href="http://git.oschina.net/dogstar/PhalApi"><img src="../images/git-oschina.png"  alt="git-oschina" /></a>
                </div>
                <div class="cls"></div>
                <div class="text-center copy_right"> ©2015-2017 PhalApi All Rights Reserved. <a href="http://www.miitbeian.gov.cn" target="_blank">粤ICP备15028808号</a>

				<script type="text/javascript">var cnzz_protocol = (("https:" == document.location.protocol) ? " https://" : " http://");document.write(unescape("%3Cspan id='cnzz_stat_icon_1255326144'%3E%3C/span%3E%3Cscript src='" + cnzz_protocol + "s4.cnzz.com/z_stat.php%3Fid%3D1255326144%26show%3Dpic' type='text/javascript'%3E%3C/script%3E"));</script>
                </div>
            </div>
        </div>
    </div>


    <a href="https://github.com/phalapi"><img id="gitHub_fllow" style="position: fixed; top: 0; right: 0; border: 0;z-index:9999" src="https://camo.githubusercontent.com/652c5b9acfaddf3a9c326fa6bde407b87f7be0f4/68747470733a2f2f73332e616d617a6f6e6177732e636f6d2f6769746875622f726962626f6e732f666f726b6d655f72696768745f6f72616e67655f6666373630302e706e67" alt="Fork me on GitHub" data-canonical-src="https://s3.amazonaws.com/github/ribbons/forkme_right_orange_ff7600.png"></a>


    <script src="../js/jquery-1.11.1.min.js"></script>
    <script src="../js/bootstrap.min.js"></script>
</body>

</html>